Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRGetVRWorld

You can use the QTVRGetVRWorld function to get the VR world atom container for a movie.

OSErr QTVRGetVRWorld (QTVRInstance qtvr, QTAtomContainer*VRWorld);
qtvr
An instance of a QuickTime VR movie.
VRWorld
On exit, a pointer to an atom container that contains information about the specified movie.
function result
A result code.

DESCRIPTION

The QTVRGetVRWorld function returns, in the VRWorld parameter, a pointer to an atom container that contains general scene information about the QuickTime VR movie specified by the qtvr parameter, as well as a list of all the nodes in that movie. You can use the QuickTime atom functions (introduced in QuickTime version 2.1) to extract atoms from that container.

See the chapter handlink "QuickTime VR File Format" for a description of the format of a VR world atom container and its associated atoms for a QuickTime VR movie.

SPECIAL CONSIDERATIONS

The VR world atom container returned by QTVRGetVRWorld is a copy of the atom container maintained internally by the QuickTime VR Manager. You should dispose of the VR world atom container (by calling the QuickTime function QTDisposeAtomContainer ) when you're finished using it.

SEE ALSO

handlink "QuickTime VR File Format/Listing 4-2" illustrates the use of QTVRGetVRWorld .

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |